home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / tlxdial3.zip / DIAL.DOC < prev    next >
Text File  |  1993-05-08  |  10KB  |  268 lines
  1. DIAL is a command line dialer for TELIX. At the DOS prompt simply type DIAL 
  2. followed by the name of a bbs in your TELIX phone directory and DIAL will 
  3. automaticaly start TELIX & begin the dialing of the chosen telephone number.
  4.  
  5. DIAL allows several command line options to specify a dial time, the use of 
  6. an alternate dialing directory, or to show a listing of all entry names in a 
  7. dialing directory (without starting TELIX). 
  8.  
  9. Most importantly, a DOS shell is provided during delayed dialing 
  10. (560K free on my machine) allowing you to perform other tasks. Upon return 
  11. from a shell, DIAL will sense if a dialing time is past & prompt to dial 
  12. now or abort, batch mode supresses this prompt and begins dialing immediately. 
  13.  
  14. A new switch that allows the user to tell TELIX to start a "script" has
  15. been added.
  16.  
  17. Requires TELIX ver 3.x or compatible dialing directory.
  18.  
  19. REGISTRATION & LICENSE
  20. ^^^^^^^^^^^^^^^^^^^^^^
  21. The registartion fee for DIAL is $10 US currency (or equivelent) payable to:
  22.  
  23.   P.SADOWSKI
  24.   76 Park Edge Drive
  25.   Buffalo, NY 14225 
  26.   USA
  27.  
  28. Alternatively, GEnie subscribers may make a $10 "Gift Of Time" to 
  29. GE MAIL Address   LOONEY.TUNES.
  30.  
  31. (See page 8080, or *GIFTOFTIME, on GEnie for Gift Of Time details.)
  32.  
  33. The author may be reached at the following email addresses:
  34.  
  35. LOONEY.TUNES                 (GEnie)
  36. aa089@freenet.buffalo.edu   (Internet)
  37. cn659@po.cwru.edu           (Internet)
  38.  
  39. DIAL is Copyright 1992, 1993 by Paul R. Sadowski (All rights reserved.)
  40. and is licensed upon registration for personal non-commercial use only.
  41. Commercial licenses available.
  42.  
  43. No warranties of any kind, including but not limited to actual, express,
  44. or implied are recognized. The user accepts this program and documentation
  45. on an AS-IS basis, and waives any claims against the author and program
  46. distributors for any damages resulting from incompatiblities, program faults
  47. or misuse.
  48.  
  49. Distribution of this program without this document, or in any altered form 
  50. is prohibited.
  51.  
  52. USAGE DETAILS
  53. ^^^^^^^^^^^^^
  54.  
  55. The basic usage is "DIAL <ENTRY NAME>". This finds the first pattern match
  56. to entry name in your default dialing directory TELIX.FON.
  57.  
  58. If your <ENTRY NAME> contains spaces, please surround the <ENTRY NAME>
  59. with double quotation marks. Eg., DIAL "A BBS" 19:30 
  60.  
  61. (NOTE: DIAL simply starts TELIX and begins dialing. It WILL NOT exit
  62. TELIX after your session is completed. You must do this yourself, or your
  63. automated scripts must do it for you.)
  64.  
  65. The "entry name" MUST be the first parameter on the line.
  66.  
  67. DIAL searches for the first entry that matches ALL of the characters in 
  68. entry name. For example, if you have the following dialing dir. entries :
  69.  
  70.         BIX
  71.         CIS
  72.         DELPHI
  73.         GENIE
  74.  
  75. typing "dial genie" will find entry #4, GENIE, as will "dial GE" or
  76. "dial gen" or "dial geni" or even "dial g" (Case is NOT considered).
  77.  
  78. However, with the following entries:
  79.  
  80.         BIX
  81.         CIS
  82.         DELPHI
  83.         GENCO
  84.         GENIE
  85.  
  86. you must specify the minimum number of distinct characters to reach GENIE :
  87. "dial geni". Typing "dial gen" would find entry #4, GENCO as it's first
  88. pattern match, not GENIE.
  89.  
  90. If no match is found, an error message will be displayed.
  91.  
  92.  
  93. DELAYED DIALING
  94. ^^^^^^^^^^^^^^^
  95. You can specify a time until which DIAL should wait to begin.
  96. The form is: "DIAL <ENTRY NAME> <TIME>".
  97.  
  98. When delayed dialing is used, Time MUST be the second parameter on the line. 
  99. If time is not used another switch may appear in that position.
  100.  
  101. DIAL uses a 24 hour, or military time format. Midnight being 00:00, 
  102. noon being 12:00, 6pm being 18:00... etc. Thus, the valid time range is
  103. 00:00 -- 23:59. 
  104.  
  105. A leading zero MUST precede hour and minute designators of 9 or less. 
  106. (Eg., 09:27, 02:02, 00:30) 
  107.  
  108. A colon MUST appear in the third position, seperating the hours and minutes.
  109.  
  110. If an invalid time is entered an error message is displayed.
  111.  
  112. Delayed dialing is principaly of use to those who have dialing scripts
  113. attached to a dialing directory entry that fully automate their activities
  114. on that service or BBS.
  115.  
  116. It is the responsibility of the script to exit TELIX and to control the
  117. maximum number of dial retries upon a busy signal or other connect problems.
  118. DIAL has nothing to do with what happens after the first dial attempt is
  119. begun.
  120.  
  121.  
  122. ALTERNATE DIALING DIRECTORIES
  123. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  124. You may tell DIAL to start TELIX with a dialing directory other than the
  125. default TELIX.FON, and to search that directory for a pattern match.
  126. The form is: "DIAL <ENTRY NAME> </:drive\pathname\filename>".
  127.  
  128. (NOTE: if delayed dialing is used, <TIME> must be the second paramater.
  129. </:\pathname\filename> and any other switches must follow <TIME>.)
  130.  
  131. You may specify a complete pathname -- such as, "c:\phones\mydir.fon", or
  132. "\comm\dialing\sues.dir" -- or just a filename, such as "petes.fon". If you
  133. do not include a file extension DIAL will assume the extension .FON. If
  134. you have included a pathname DIAL will search only that drive & directory
  135. specified. If the environment variable TELIX has been set and no pathname
  136. is given DIAL will search the path specified by that variable. If that
  137. variable is not set and no pathname is given DIAL searches only the current
  138. directory.
  139.  
  140. The virgule '/' or reverse backslash followed by a colon is required.
  141. Eg., "dial delphi 19:30 /:c:\telix\mydir\pauls.fon"
  142.  
  143. If DIAL can not find the specified file an error message is displayed.
  144.  
  145. LISTING ENTRIES
  146. ^^^^^^^^^^^^^^^
  147. You may view the entry names in the default dialing directory, or any
  148. dialing directory, without starting TELIX.
  149.  
  150. The form is: "DIAL </L>" or "DIAL </L> </:drive\pathname\filename>"
  151.  
  152. This is the ONLY case where entry name and/or time need not be given.
  153.  
  154. A two column listing of all entry names will be displayed. If any name
  155. field in the dialing directory is blank, DIAL will display it as <<EMPTY>>.
  156. (DIAL will not dial a blank entry.) If you have many entries in your
  157. dialing directory you may wish to use the DOS MORE command to prevent the
  158. entries from scrolling off your screen. (Eg., "DIAL /L|MORE")
  159.  
  160. FINDING FILES
  161. ^^^^^^^^^^^^^
  162. TELIX uses the environment variable TELIX to find it's required files.
  163. DIAL also uses this variable to find both TELIX and it's default dialing
  164. directory. If you do not have this variable set, DIAL will search only
  165. the current directory for TELIX.EXE. If it can't find it, an error message
  166. will be displayed.
  167.  
  168. If you have both TELIX set and your TELIX diectory in your PATH, you may
  169. run DIAL from whatever your current directory happens to be, as long as
  170. either DIAL is in that directory or in your PATH. (It's easiest just to
  171. place DIAL in your TELIX directory.)
  172.  
  173. MUST KNOW
  174. ^^^^^^^^^
  175. DIAL "knows" each day as beggining at 00:00 and ending at 23:59; therefore,
  176. when DIAL sees a time entry such as 02:30 (2:30 a.m.) before midnight
  177. current time and after that time for this day, it thinks that time has passed 
  178. and asks you if you want it to continue or not.
  179.   
  180.   Past that time for today. Continue anyway, Press Y or N : [N]?
  181.  
  182. Press 'Y' to continue (case is not observed), or 'N' or just return to
  183. abort. 
  184.  
  185. DIAL does not currently distinguish between days of the week on the 
  186. command line, but it does do so "internaly." So pressing 'Y' will have
  187. DIAL display the next day of the week in its waiting message and act
  188. appropriately when returning from a DOS shell -- ie., not dialing till
  189. the stated time on the day indicated in its waiting message.
  190.  
  191. While waiting to dial a message similiar to the one below will be displayed.
  192.  
  193.     Waiting to dial <ENTRY NAME> on <DAY> at <TIME>.
  194.     Press <ESC> to shell to DOS, <Q> to quit, <D> to Dial now.
  195.  
  196.     <<current time clock>>
  197.  
  198. At any time you may press the letter 'Q' to abort the dial, 'D' to cause
  199. DIAL to begin dialing immediately, or press the <escape> key to start a
  200. DOS SHELL to perform other work on your computer.
  201.  
  202. Type EXIT at the DOS prompt to return from the shell. 
  203.  
  204. DIAL has been kept small to preserve a useful amount of free memory when 
  205. you do a DOS SHELL. On